home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / advbas26.arc / ADVBAS.QRF < prev   
Text File  |  1986-09-19  |  10KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                           ADVBAS v2.6 Quick Reference
  8.  
  9.  
  10.  
  11.      Note: variable  names  here  are  chosen  for  special clarity and may not
  12.  match  those  found  in  the ADVBAS.DOC file.  The names of the variables used
  13.  are  not  important  per  se  and  may  be  changed  readily.  This is a quick
  14.  reference  for  your  convenience,  and is not intended to be used without the
  15.  DOC file!
  16.  
  17.  
  18.  
  19.  
  20.  ADDMATI       Add a scalar to an array.
  21.                CALL ADDMATI(ARRAYLOC, ARRAYSIZE, SCALAR, OVFLOWERR)
  22.  
  23.  ANY2DEC       Convert an integer in any base (2-35) to decimal (base 10).
  24.                CALL ANY2DEC(ANUM$, NBASE, DNUM, ERCD)
  25.  
  26.  BKSCROLL      Scroll part of the screen backwards or clear it.
  27.                BKSCROLL(LEFTCOL, TOPROW, RTCOL, BOTROW, LINES)
  28.  
  29.  BKSPACE       Destructive backspace.
  30.                CALL BKSPACE(COL, ROW): LOCATE ROW, COL
  31.  
  32.  BSQ           Squeeze the blanks out of a text string by encoding it.
  33.                CALL BSQ(ST$, SLEN)
  34.  
  35.  BUSQLEN       Tell how long a BSQed string will be once unsqueezed.
  36.                CALL BUSQLEN(ST$, SLEN)
  37.  
  38.  BUSQ          Unsqueeze a BSQed string (use this -after- BUSQLEN).
  39.                CALL BUSQ(ST$, USQST$)
  40.  
  41.  CHECKSUM      Calculate Xmodem-type checksum for a string.
  42.                CALL CHECKSUM(RECORD$, CHKSUM)
  43.  
  44.  CLREOL        Clear to the end of the current screen line.
  45.                CALL CLREOL
  46.  
  47.  CRC           Calculate Xmodem-type Cyclical Redundancy Check.
  48.                CALL CRC(RECORD$, HICRC, LOCRC)
  49.  
  50.  DEC2ANY       Converts a decimal (base 10) integer to any base (2-35).
  51.                CALL DEC2ANY(DNUM, NBASE, ANUM$, ALEN)
  52.  
  53.  DELCHR        Delete a char from the specified screen location.
  54.                CALL DELCHR(ROW, COL)
  55.  
  56.  DELSUB        Delete a subdirectory.
  57.                SUBDIR$ = SUBDIR$ + CHR$(0): CALL DELSUB(SUBDIR$, ERRCD)
  58.  
  59.  DMPRINT       Displays a string using only DOS functions.
  60.                CALL DMPRINT(ST$)
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  DRVSPACE      Return free space left on disk (error returns negative value).
  74.                CALL DRVSPACE(DRV$, A,B,C): FREE = CSNG(A)*CSNG(B)*CSNG(C)
  75.  
  76.  EXTRACT       Extract a substring from a string using a given delimiter.
  77.                CALL EXTRACT(ST$, DLM$, INDEX, START, SLEN):
  78.                SUBSTR$ = MID$(ST$, START, SLEN)
  79.  
  80.  FINDFIRSTF        Get  a file using wildcards (used for first call).  See also
  81.                FINDNEXTF, GETNAMEF, GETATTRF, GETDATEF, GETTIMEF, GETSIZEF.
  82.                FIL$ = FIL$ + CHR$(0): CALL FINDFIRST(FIL$, ATTR, ERRCD)
  83.  
  84.  FINDNEXTF     Get the next file using wildcards (see FINDFIRSTF et al).
  85.                CALL FINDNEXTF(ERRCD)
  86.  
  87.  GETATTRF      Get the attribute of a file found with FINDxxxF.
  88.                CALL GETATTRF(ATTR)
  89.  
  90.  GETDATEF      Get the date of a file found with FINDxxxF.
  91.                CALL GETDATEF(MONTH, DAY, YEAR)
  92.  
  93.  GETDOSV       Get the current DOS version.
  94.                CALL GETDOSV(MAJORV, MINORV)
  95.  
  96.  GETDRV        Get the current default disk drive.
  97.                DRV$ = " ": CALL GETDRV(DRV$)
  98.  
  99.  GETFATTR      Get the attribute of a file.
  100.                FIL$ = FIL$ + CHR$(0): CALL GETFATTR(FIL$, ATTR)
  101.  
  102.  GETFDATE      Get the date of a file.  If error, MONTH set to -1.
  103.                FIL$ = FIL$ + CHR$(0): CALL GETFDATE(FIL$, MONTH, DAY, YEAR)
  104.  
  105.  GETFTIME      Get the (24hr) time of a file.  If error, HOUR set to -1.
  106.                FIL$ = FIL$ + CHR$(0): CALL GETFTIME(FIL$, HOUR, MINUTE, SECOND)
  107.  
  108.  GETKEY        Wait for and return one of a specified list of keys.
  109.                KY$=" ": CALL GETKEY(GOODKEY$, KY$)
  110.  
  111.  GETLINE       Returns a selected line from a saved screen (see SCRSAVE).
  112.                LINE$ = SPACE$(80): CALL GETLINE(SCRLOC, LINENR, LINE$, LLEN):
  113.                LINE$ = LEFT$(LINE$, LLEN)
  114.  
  115.  GETNAMEF      Get the filename of a file found using FINDxxxF.
  116.                FIL$ = SPACE$(12): CALL GETNAMEF(FIL$, FLEN):
  117.                FIL$ = LEFT$(FIL$, FLEN)
  118.  
  119.  GETSIZEF      Get the size of a file found using FINDxxxF.
  120.                CALL GETSIZEF(SIZELO, SIZEHI): SIZELO# = CDBL(SIZELO):
  121.                IF SIZELO<0 THEN SIZELO# = SIZELO# + 65536#
  122.                FILESIZE# = SIZELO# + CDBL(SIZEHI#) * 65536#
  123.  
  124.  GETSUB        Get the default subdirectory.
  125.                SUB$ = STRING$(64,0): CALL GETSUB(SUB$, SLEN):
  126.                SUB$ = "\" + LEFT$(SUB$, SLEN)
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  GETTIMEF      Return the (24hr) time of a file found using FINDxxxF.
  140.                CALL GETTIMEF(HOUR, MINUTE, SECOND)
  141.  INSCHR        Insert a space at the specified screen location.
  142.                CALL INSCHR(ROW, COL)
  143.  
  144.  KEYPRESS      Returns nonzero if a key is waiting in the keyboard buffer.
  145.                CALL KEYPRESS(KYHIT)
  146.  
  147.  LOCASE        Convert uppercase characters to lowercase.
  148.                CALL LOCASE(ST$)
  149.  
  150.  LROTATE       Rotate the characters in a string left once.
  151.                CALL LROTATE(ST$)
  152.  
  153.  MAKESUB       Make a subdirectory.  Sets ERRCD if error.
  154.                SUB$ = SUB$ + CHR$(0): CALL MAKESUB(SUB$, ERRCD)
  155.  
  156.  MDELCHR       Delete char at current cursor position, obeying MWINDOW (qv).
  157.                CALL MDELCHR.
  158.  
  159.  MINSCHR       Insert space at current cursor position, obeying MWINDOW (qv).
  160.                CALL MINSCHR.
  161.  
  162.  MPRINTC       Display a character using DOS calls, obeying MWINDOW (qv).
  163.                CALL MPRINTC(CH$, COL, ROW): LOCATE ROW, COL
  164.  
  165.  MPRINT        Display a string using DOS calls, obeying MWINDOW (qv).
  166.                CALL MPRINT(ST$, COL, ROW): LOCATE ROW, COL
  167.  
  168.  MULTIAND      Performs AND on each char of a string with a supplied value.
  169.                CALL MULTIAND(ST$, ANDVAL)
  170.  
  171.  MULTIOR       Performs OR on each char of a string.
  172.                CALL MULTIOR(ST$, ORVAL)
  173.  
  174.  MULTIXOR      Performs XOR on each char of a string.
  175.                CALL MULTIXOR(ST$, XORVAL)
  176.  
  177.  MWINDOW       Set up a screen window for MPRINT/MPRINTC/MINSCHR/MDELCHR.
  178.                CALL MWINDOW(LEFTCOL, TOPROW, RTCOL, BOTROW)
  179.  
  180.  QPRINT        Quick print to screen.  Doesn't understand control codes.
  181.                CALL QPRINT(ST$, ROW, COL)
  182.  
  183.  READBITF      Returns a value from an array of arbitrary (1-8) bit length.
  184.                CALL READBITF(ARRAYLOC, INDEX, BITLEN, VALUE)
  185.  
  186.  RECOLOR       Switch everything on the screen of one color to another (text).
  187.                CALL RECOLOR(OLDCOLRATTR, NEWCOLRATTR)
  188.  
  189.  REVERSE       Reverse the chars in a string.
  190.                CALL REVERSE(ST$)
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  RROTATE       Rotate the chars in a string right once.
  206.                CALL RROTATE(ST$)
  207.  
  208.  SCROLL        Scroll a section of the screen or clear it.
  209.                CALL SCROLL(LEFTCOL, TOPROW, RTCOL, BOTROW, LINES)
  210.  
  211.  SCRREST       Restore the screen display from an array (see SCRSAVE).
  212.                CALL SCRREST(ARRAYLOC)
  213.  
  214.  SCRRESTP      Restore the screen display to a given page from an array.
  215.                CALL SCRREST(ARRAYLOC, SCRNPAGE)
  216.  
  217.  SCRRESTPD     Restore the screen to a given page with direct screen writes.
  218.                CALL SCRREST(ARRAYLOC, SCRNPAGE)
  219.  
  220.  SCRSAVE       Save the current screen display to an array.
  221.                CALL SCRSAVE(ARRAYLOC)
  222.  
  223.  SCRSAVEP      Save the display on a given screen page to an array.
  224.                CALL SCRSAVEP(ARRAYLOC, SCRNPAGE)
  225.  
  226.  SCRSAVEPD     Save a given screen page with direct screen reads to an array.
  227.                CALL SCRSAVEPD(ARRAYLOC, SCRNPAGE)
  228.  
  229.  SETCOMM       Set a communications port to the given parameters.
  230.                CALL SETCOMM(COMMPORT, BPS, PARITY, WORDLENGTH, STOPBITS)
  231.  
  232.  SETDRV        Set the default drive.
  233.                DRV$ = "B": CALL SETDRV(DRV$)
  234.  
  235.  SETFATTR      Set a file's attribute.
  236.                FIL$ = FIL$ + CHR$(0): SETFATTR(FIL$, ATTR)
  237.  
  238.  SETFTD        Set a file's time and date.  If error, return -1 in MONTH.
  239.                FIL$ = FIL$ + CHR$(0):
  240.                CALL SETFTD(FIL$, MONTH, DAY, YEAR, HOUR, MINUTE, SECOND)
  241.  
  242.  SETMATI       Set an array to a given scalar (integer) value.
  243.                CALL SETMATI(ARRAYLOC, ARRAYSIZE, VALUE)
  244.  
  245.  SETSUB        Set the default subdirectory.  Returns -1 if error.
  246.                SUB$ = SUB$ + CHR$(0): CALL SETSUB(SUB$, ERRCD)
  247.  
  248.  SOUNDEX       Returns the Soundex code for a string.
  249.                SCODE$ = ST$: CALL SOUNDEX(ST$, SCODE$, SLEN):
  250.                SCODE$ = LEFT$(SCODE$, SLEN)
  251.  
  252.  STRIP         Strips occurrences of a target character from a string.
  253.                CALL STRIP(ST$,TCHR$,SLEN): ST$ = LEFT$(ST$, SLEN)
  254.  
  255.  STRIPRANGE    Strips chars within a given (inclusive) range from a string.
  256.                CALL STRIPRANGE(ST$, LO, HI, SLEN): ST$ = LEFT$(ST$, SLEN)
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  UPCASE        Convert a string to uppercase.
  272.                CALL UPCASE(ST$)
  273.  
  274.  WEEKDAY       Return the weekday (1 - 7, Sunday thru Saturday).
  275.                CALL WEEKDAY(DAY)
  276.  
  277.  WRITEBITF     Put a value in an array of arbitrary (1-8) bit length.
  278.                CALL WRITEBITF(ARRAYLOC, INDEX, BITLEN, VALUE)
  279.  
  280.  XLATE         Translate a string, char by char, using a translation table.
  281.                CALL XLATE(CH$, XLATETABL$)
  282.  
  283.  XMPRINT       Translate a char, and if it's not NUL, display it via DOS.
  284.                CALL XMPRINT(CH$, XLATETABL$, COL, ROW): LOCATE ROW, COL
  285.  
  286.  XQPRINT       Extended quick print, with color and page selection.
  287.                CALL XQPRINT(ST$, ROW, COL, COLOUR, PAGE)
  288.  
  289.  XQPRINTD      Extended direct quick print, with color and page selection.
  290.                CALL XQPRINTD(ST$, ROW, COL, COLOUR, PAGE)
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.